The Arsenal Files 3

home *** CD-ROM | disk | FTP | other *** search

/ The Arsenal Files 3 / The Arsenal Files 3.iso / ra / pscn113e.exe / rar / PALMSCAN.DOC < prev next >

Wrap

Text File | 1994-12-04 | 124KB | 3,428 lines

PalmScan v1.13 The Ultimate Archive Conversion Utility User guide PalmScan v1.13 The Ultimate Archive Conversion Utility December 4, 1994 Software and documentation written by Steven Hendriks Copyright (C) 1993,94 by Steven Hendriks All rights reserved. All information in this documentation is subject to change without prior notice PalmScan v1.13 User guide ----------------------------------------------------------------------- Table of Contents 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 1.1 Copyright and License Agreement . . . . . . . . . . . . . . . 5 1.2 Contacting the author . . . . . . . . . . . . . . . . . . . . 6 1.3 What is PalmScan . . . . . . . . . . . . . . . . . . . . . . 6 1.4 Features . . . . . . . . . . . . . . . . . . . . . . . . . . 7 1.5 System requirements . . . . . . . . . . . . . . . . . . . . . 8 1.6 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 1.7 Included files . . . . . . . . . . . . . . . . . . . . . . . 9 1.8 Runtime . . . . . . . . . . . . . . . . . . . . . . . . . . . 9 2 Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 10 2.1 First time installation . . . . . . . . . . . . . . . . . . 10 2.2 Installing PalmScan in FileDoor . . . . . . . . . . . . . . 10 2.3 Installing PalmScan in SuperBBS . . . . . . . . . . . . . . 10 2.4 Installing PalmScan in Allfix . . . . . . . . . . . . . . . 11 2.5 Installing PalmScan in RemoteAccess 2.0x . . . . . . . . . 11 2.6 Installing PalmScan in The Remote Access Filearea Tools . . 11 2.7 Installing PalmScan in Maximus . . . . . . . . . . . . . . 12 2.8 Installing PalmScan in Ezycom . . . . . . . . . . . . . . . 13 2.9 Commandline . . . . . . . . . . . . . . . . . . . . . . . . 14 2.10 Watchdog, CTTY, ANSI.SYS . . . . . . . . . . . . . . . . . 19 2.11 Errorlevels . . . . . . . . . . . . . . . . . . . . . . . . 19 3 The configuration . . . . . . . . . . . . . . . . . . . . . . . 20 3.1 PALMSCAN.CFG . . . . . . . . . . . . . . . . . . . . . . . 20 3.2 PSetup . . . . . . . . . . . . . . . . . . . . . . . . . . 21 3.2.1 Commandline . . . . . . . . . . . . . . . . . . . . 21 3.2.2 Starting PSetup . . . . . . . . . . . . . . . . . . 21 3.2.3 Keys . . . . . . . . . . . . . . . . . . . . . . . . 21 3.2.4 System data . . . . . . . . . . . . . . . . . . . . 22 BBS name . . . . . . . . . . . . . . . . . . . . . . 22 Key number . . . . . . . . . . . . . . . . . . . . . 22 SysOp name . . . . . . . . . . . . . . . . . . . . . 22 Net address . . . . . . . . . . . . . . . . . . . . 23 Uploader name . . . . . . . . . . . . . . . . . . . 23 3.2.5 Screen settings . . . . . . . . . . . . . . . . . . 24 Redirect screen output of external programs . . . . 24 Normal color . . . . . . . . . . . . . . . . . . . . 24 Highlighted color . . . . . . . . . . . . . . . . . 24 Background color . . . . . . . . . . . . . . . . . . 24 3.2.6 General settings . . . . . . . . . . . . . . . . . . 25 Running under FileDoor . . . . . . . . . . . . . . . 25 Update FILES.BBS / Extended descriptions character . 25 Spaces to indent . . . . . . . . . . . . . . . . . . 25 Download counters . . . . . . . . . . . . . . . . . 26 File-DataBase . . . . . . . . . . . . . . . . . . . 27 Import FILE_ID description . . . . . . . . . . . . . 28 Import FILE_ID description to Ezycom 1.10 . . . . . 29 Describe MOD's . . . . . . . . . . . . . . . . . . . 29 3.2.7 Archive Conversion settings . . . . . . . . . . . . 30 Only process new files . . . . . . . . . . . . . . . 30 Only process listed files . . . . . . . . . . . . . 31 Put FILE_ID description in archive header . . . . . 31 Archive conversion . . . . . . . . . . . . . . . . . 31 Convert ALL archives . . . . . . . . . . . . . . . . 33 Process Self-Extracting archives . . . . . . . . . . 33 Process embedded archives . . . . . . . . . . . . . 33 PalmScan v1.13 User guide ----------------------------------------------------------------------- Add CRC file list . . . . . . . . . . . . . . . . . 34 No title in headers . . . . . . . . . . . . . . . . 34 New archive date . . . . . . . . . . . . . . . . . . 35 3.2.8 Paths / filenames . . . . . . . . . . . . . . . . . 36 Temporary directory . . . . . . . . . . . . . . . . 36 Bad files directory . . . . . . . . . . . . . . . . 36 Infected files directory . . . . . . . . . . . . . . 36 Hacked files directory . . . . . . . . . . . . . . . 37 Old files directory . . . . . . . . . . . . . . . . 37 Bad GIF files directory . . . . . . . . . . . . . . 37 Messagebase path . . . . . . . . . . . . . . . . . . 38 BBS system directory . . . . . . . . . . . . . . . . 38 Files.bbs filename . . . . . . . . . . . . . . . . . 39 Log file / log style . . . . . . . . . . . . . . . . 39 Archive header file . . . . . . . . . . . . . . . . 40 Substitute drive . . . . . . . . . . . . . . . . . . 40 3.2.9 Archivers . . . . . . . . . . . . . . . . . . . . . 41 3.2.10 Archivers - Archive protection . . . . . . . . . . . 42 UC2 protection . . . . . . . . . . . . . . . . . . . 42 RAR lock . . . . . . . . . . . . . . . . . . . . . . 42 3.2.11 Virus scan . . . . . . . . . . . . . . . . . . . . . 43 Files to scan . . . . . . . . . . . . . . . . . . . 43 Virus scanners . . . . . . . . . . . . . . . . . . . 43 Complete scan . . . . . . . . . . . . . . . . . . . 45 3.2.12 HackList . . . . . . . . . . . . . . . . . . . . . . 46 3.2.13 Skip files . . . . . . . . . . . . . . . . . . . . . 46 3.2.14 Pack unpacked . . . . . . . . . . . . . . . . . . . 47 Minimum size . . . . . . . . . . . . . . . . . . . . 47 3.2.15 Remove files . . . . . . . . . . . . . . . . . . . . 47 3.2.16 Add files . . . . . . . . . . . . . . . . . . . . . 48 3.2.17 GIF settings . . . . . . . . . . . . . . . . . . . . 48 Add GIF specifications to descriptions . . . . . . . 48 GIF pack . . . . . . . . . . . . . . . . . . . . . . 49 JFIF unpack . . . . . . . . . . . . . . . . . . . . 49 JPEG unpack . . . . . . . . . . . . . . . . . . . . 50 GIFblast unpack . . . . . . . . . . . . . . . . . . 50 Repack JFIF files . . . . . . . . . . . . . . . . . 50 Repack JPEG files . . . . . . . . . . . . . . . . . 50 Repack GIFblast files . . . . . . . . . . . . . . . 51 Minimum resolution . . . . . . . . . . . . . . . . . 51 GIF test command / failures . . . . . . . . . . . . 51 3.2.18 Old files . . . . . . . . . . . . . . . . . . . . . 52 3.2.19 Information . . . . . . . . . . . . . . . . . . . . 52 3.2.20 Exit to dos . . . . . . . . . . . . . . . . . . . . 52 4 Registration . . . . . . . . . . . . . . . . . . . . . . . . . . 53 5 Credits . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 I Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 PalmScan v1.13 User guide ----------------------------------------------------------------------- 1 Introduction 1.1 Copyright and License Agreement 'PalmScan' refers to all executables and documentation as distributed in the compressed file in which the package was released. Users of PalmScan must accept this disclaimer of warranty: - PalmScan is copyrighted material by Steven Hendriks. It may only be used in agreement with the conditions set out in this license agreement. - PalmScan is released as shareware. - You may use PalmScan for an evaluation period of one month. After this period you MUST either register PalmScan or stop using it. - Registration is REQUIRED for commercial usage (in a commercial environment, such as business, governmental organization, association, school, foundation, or any other form of juridical person, or any system where PalmScan is directly or indirectly used to make profit). - PalmScan may be distributed freely provided no money or any other compensation is asked or accepted without prior written permission from the author. - PalmScan is supplied as is, without warranty or guarantee of any kind, either expressed or implied, as to the fitness for a particular purpose or quality or performance of this program, except that PalmScan will occupy some disk space. - In no event shall Steven Hendriks be liable to you or anyone else for any damages or cost, including, but not limited to, any lost profits, lost savings or lost income which may result from the use or inability to use PalmScan. - In no way is Steven Hendriks obligated to you or anyone else to provide future versions of, or support for PalmScan. - Steven Hendriks reserves the right not to release future shareware versions of PalmScan, but switch to a commercial marketing concept instead. - It is forbidden to modify, adapt, translate, reverse engineer, decompile and/or disassemble the software in this package. Patching the medium at places that carry the software (including, but not limited to, RAM memory and physical media) is seen as a program change and is also forbidden. - Your use of PalmScan constitutes your agreement to this license and disclaimer and your release of the author from any form of liability or litigation. - 5 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 1.2 Contacting the author If you have any problems with PalmScan, or if you wish to contact the author for suggestions etc., you can: - Call Oasis BBS (300 - 28800 bps) at +31-1881-3132 - Send a NetMail message to Steven Hendriks at: Fidonet 2:2802/140 VirNet 9:310/0 DigitalNet 15:1100/300 SIGnet 27:1331/40 OasisNet 52:52/0 AlarmNet 64:300/0 OASE 200:3110/0 - Send E-Mail to: stv_hendriks@hrovx1.hro.nl steven.hendriks@f140.n2802.z2.fidonet.org (preferred) - Send an echomail message in the OASISSOFT support echo. - Send an echomail message in an appropriate area in one of the above networks (I can't read _all_ areas, especially not all Fidonet areas, use netmail if you are not sure whether I'm reading an area or not). - Send a letter to this address: Steven Hendriks Hoofd 22 3214AH Zuidland Netherlands 1.3 What is PalmScan PalmScan is the conversion utility to convert almost any archive to another format. It can check for viruses inside the archives while converting (with up to 20 virus scanners), get file descriptions, process embedded archives, remove/add files from/to archives, full support for GIF packing, and lots more! PalmScan has full FileDoor, FILES.BBS and Remote- Access 2.0x and Ezycom 1.02 and 1.10 file- database support, works with any door.sys or dorinfo supporting bbs program, works great in Allfix and many other programs, or stand-alone! - 6 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 1.4 Features - A very flexible configuration. You can configure almost anything the way you want it. - Detects these archive types: - ARC - PAK * - ZIP * ~ - LHA * - ZOO - SQZ * - HYP - ARJ * ~ @ - HAP - UC2 ~ - RAR * ~ @ * Self-extracting archives are detected. ~ Security envelopes / authenticity validations / seals are detected. @ Multi-volume archives are supported. PalmScan can detect other archives by looking at the archive extension. Other archivers could be added, just send the archiving program to the author and support will be added, if possible. - Supports up to 30 different archive types. - Supports GIF packing. - Full FileDoor support (for FileDoor's ExitAfterUpload). - Special FILES.BBS support. - Full support for the RemoteAccess 2.0x, Ezycom 1.02 and Ezycom 1.10 file-databases, including an advanced maintenance feature. - Virus scanning with up to 20 virus scanners. - Checking files in a hacklist. - Reject files which are too old. - Compress un-archived files with your favourite archiver. - Get file descriptions from FILE_ID.DIZ and DESC.SDI. - Describes music files, like MOD, ScreamTracker, organ files, etc. - Describes Compuserve GIF pictures. - Tests GIF pictures. - 7 - PalmScan v1.13 User guide ----------------------------------------------------------------------- - Ability to notify the SysOp about infected, bad, hacked and old archives and bad GIF files. PalmScan supports Fido (*.msg), Hudson, Squish, Ezycom (both 1.02 and 1.10) and JAM messagebases. - Add and remove files to/from archives. - Add file list with CRC-32's. - Writes a complete log file. - Runs under any BBS system which supports the DOOR.SYS or DORINFO.DEF dropfile format. Without one of these dropfiles, PalmScan can be run in local-only mode. - Supports both ANSI and ASCII when running in online mode. - Built-in Fossil support and carrier detection. - Very user-friendly; virtually anything can be configured. - A very easy-to-use setup program is included. - High quality performance, very low registration fee. 1.5 System requirements - IBM PC, XT, AT or compatible. - IBM PC-DOS or Microsoft MS-DOS 3.0 (or compatible) or higher. - At least 20 file handles ('FILES=20' in your CONFIG.SYS). A lower value can cause 'Out of file handles' errors. - At least 350 KB conventional memory available. - At least one of the following compression utilities: PKARC, PKZIP, LHA, ZOO, SQZ, Hyper, ARJ, HAP, PAK, UC2. - A disk cache can improve performance, but is not required. If you are not using a disk cache, make sure that the number of DOS buffers is at least 30 ('BUFFERS=30' in your CONFIG.SYS) to improve performance. - 8 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 1.6 Logging PalmScan can keep track of its activity in a log file. When no filename is given in the configuration, logging is turned off. The following characters are used in the log, to make things a bit clearer: ! : Fatal error ? : Other (non-fatal) error or an infected/hacked/bad archive has been found $ : User information # : Other information + : Statistics · : Debug information ■ : Debug information, external programs execution 1.7 Included files This package includes: PALMSCAN.EXE The main program PALMSCAN.OVR Overlay file for the message system PALMSCAN.DOC This documentation PSETUP.EXE PalmScan SETUP program PSREG.EXE Self-extracting archive containing the registration forms PALMSCAN.CFG Sample configuration file PALMSCAN.ANS Ansi advertisement FILE_ID.DIZ Package description UPDATE.LOG Update log FILEINFO.INC Technical information about the PalmScan FileInfo system 1.8 Runtime While PalmScan is running, no user input is required. To abort processing of files, you can press escape. PalmScan will then finish the file which is currently being processed, and after that ask whether you wish to continue processing or not. - 9 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 2 Installation 2.1 First time installation PalmScan and all files included can be placed either in a separate directory, or in the BBS directory. the most common way is creating a sub-directory under the BBS directory, and place the files there. After placing all files in a directory, edit PALMSCAN.CFG. 2.2 Installing PalmScan in FileDoor The most common way for installing PalmScan in FileDoor is the following: ExitAfterUpload1 C:\PALMSCAN\PALMSCAN.EXE $U\*.* $N $M $U\*.* tells PalmScan which files to process. $N tells FileDoor to execute PalmScan only when files are received. $M tells FileDoor to swap to disk/EMS before executing PalmScan. I recommend using the 'FileDoor' keyword in the configuration, PalmScan will then tell FileDoor the new filename when a file has been converted, and the original size of the archive. By using 'FileID' also, PalmScan will also tell FileDoor the description (when found in FILE_ID.DIZ or DESC.SDI). You should never use 'FilesBBS' when running under FileDoor. 2.3 Installing PalmScan in SuperBBS The most common way for installing PalmScan in SuperBBS is the following: Virus scanner: c:\xfd\palmscan\palmscan.exe %1 *S %1 tells PalmScan which file to process. *S tells SuperBBS to swap to disk/EMS before executing PalmScan. You should not use archive conversion when PalmScan is used as virus scanner in SuperBBS. After uploads, SuperBBS would not be able to find the file back when it's got another filename. For using archive conversion, you should run PalmScan in an event, with 'FilesBBS' and 'OnlyNewFiles' switched on. - 10 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 2.4 Installing PalmScan in Allfix Allfix version 4.21 (and later) has the option to use an external archive conversion utility. The most common way for installing PalmScan in Allfix at this option is the following: EAC : PALMSCAN.EXE @1 /L /L tells PalmScan to run in local-only mode (Allfix doesn't have a user online anyway...) . @1 tells PalmScan which file to process. The errorlevels should be configured like this: (EAC) virus errorlevel 198 (EAC) error errorlevel 1 PalmScan returns errorlevel 203 for bad archives (archives which can't be unpacked), errorlevel 212 for hacked files and errorlevel 213 for virus-infected archives. With these errorlevel settings in Allfix, it will move the file to the bad directory if one of these occur. You should not configure a 'BadPath' and 'InfectedPath' in the PalmScan configuration, Allfix will move bad or infected archives to the BadTick directory (when the errorlevels are configured as above). Also, 'FilesBBS', 'FDB' and 'FileDoor' should not be used, else PalmScan would create files which are of no use for Allfix. 2.5 Installing PalmScan in RemoteAccess 2.0x The commandline for using PalmScan in the upload scan option in RemoteAccess 2.0x should be: PALMSCAN.EXE @ *M If you are using the file-database in RemoteAccess 2.0x, you should also enable this option ('FDB RA') in the PalmScan configuration. 2.6 Installing PalmScan in The Remote Access Filearea Tools The commandline for using PalmScan in the ARCCONV option in The Remote Access Filearea Tools should be: PALMSCAN.EXE %F @1 /L - 11 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 2.7 Installing PalmScan in Maximus If you don't already use the VirusCheck option in Maximus, you should first uncomment the following line in MAX.CTL: Upload Check Virus Vircheck.Bat If you want to use the DORINFOx.DEF support of PalmScan, you should also make a few changes to the MENUS.CTL file. Usually the upload command is looking like this: Upload Limited "Upload (send)" Maximus includes a mecca script called DORINFO.MEC, which produces a DORINFO1.DEF. The new structure of the upload command should be as follows: Display_File C:\Max\Dorinfo Limited "Upload (send)" NoDsp Upload Limited "U" This way whenever a user begins the upload procedure, a DORINFO1.DEF file is created. You can now edit the VIRCHECK.BAT to include the following: PalmScan %1%2%3 /NoConversion /D[path to DORINFOx.DEF] If you don't want to use the DORINFOx.DEF support, it should be this way: PalmScan %1%2%3 /NoConversion /L Warning! Do not use spaces between the commandline variables (%1,%2 and %3) or nothing will work properly. You can find the location where the DORINFOx.DEF file will be created by viewing the DORINFO.MEC file, located in the Misc directory. You must not forget to SILT (compile) the configuration after changing the .CTL files. When PalmScan finds the archive to be bad or infected, it will remove it from the upload directory. After returning to the BBS, Maximus will then not find the file present and it won't credit the user for it, and the file won't be placed in the FILES.BBS. The 'ArchiveConversion' keyword should not be used in the PalmScan configuration for running PalmScan inside Maximus, while Maximus would think the file is missing when the filename is changed. You can also use the /NOCONVERSION commandline option for PalmScan instead of disabling the ArchiveConversion keyword (this can be especially useful when using PalmScan to convert the archives in an event, and using only one configuration for PalmScan). For doing archive conversions, FileID insertion and FILES.BBS update options, run PalmScan in an event or just after exiting Maximus, with the 'OnlyNewFiles', 'FileID' and 'FilesBBS' keywords turned on. - 12 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 2.8 Installing PalmScan in Ezycom There are various ways of using PalmScan with Ezycom. When using PalmScan in one of the conversion batch-files used by Ezycom, PalmScan will not update the Ezycom file-database. Ezycom will handle this itself, so you should disable 'FDB Ezycom' when PalmScan is started from one of those batch-files. When using PalmScan with UPCONV.BAT, the commandline should be as follows for Ezycom 1.02: PalmScan.Exe %1%4.%6 /NoFDB /NoFilesBBS For Ezycom 1.10, the commandline should be: PalmScan.Exe %2%5.%7 /N%1 /T%6 /NoFDB /NoFilesBBS When used in DOCONV.BAT, /L should be added to that. The best way to use PalmScan with Ezycom is by not using it in these batch-files, but running it in an event with the FDB maintenance feature (/FDBMAINT commandline option). You could also run PalmScan after every caller, processing only the upload directory (/FDBMAINT<areanr>). - 13 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 2.9 Commandline The PalmScan commandline consists of: PALMSCAN.EXE [FileSpecs|@ListFile|Command] <Options> [..] is mandatory <..> is optional [FileSpecs] must be valid DOS file-specifications. At least one should be given, up to 30 can be given. File-specifications can be either filenames or directories. In the last case, all files in that directory will be processed. Example : PalmScan *.ZIP [@ListFile] Instead of (a) file-specification(s), you can also use a listfile. This listfile should contain valid file-specifications (see above). PalmScan will process all file-specifications in the listfile (there is no maximum size for the listfile!). The file-specifications should be placed on the first part of each line, 2everything behind it will be ignored. Example listfile: d:\files\upload This is the upload directory d:\files\incoming This is the incoming files directory In this example, all files in the directory's d:\files\upload and d:\files\incoming, will be processed (except for those files configured with the SkipFile keyword in the PalmScan configuration). The comments behind the directory's will be ignored. You can also use FLSEARCH.CTL (QuickBBS format) with this option. Example : PalmScan @C:\BBS\FLSEARCH.CTL - 14 - PalmScan v1.13 User guide ----------------------------------------------------------------------- [Command] : /FDBmaint<areanr<-areanr>> Usage : Run Ezycom/RemoteAccess file-database maintenance. PalmScan will first search the file-database for files which have not been processed, and place them in a file called FILEINFO.FIX. After that, the PalmScan FileInfo system will take over and those files will be processed. Files will be converted to the archiver configured in the Ezycom/RemoteAccess file-area configuration. When no archiver is configured for an area, PalmScan will not process files in that area. When running with Ezycom, PalmScan will use the checked bit in the file-database to determine wether a file has been processed or not. When running with RemoteAccess, PalmScan uses LASTSCAN.PS in the file-database directory to store the last time when the FDB maintenance has been run. All files which have an upload date after the date of that file will be processed. <areanr-<areanr>> The area numbers which should be processed. A range of areas can be given here (eg. 10-20) or just one area can be given. When no area number is specified, PalmScan will process all areas which have a destination archiver configured. Any file specifications given on the commandline will be used to determine wether a file should be processed or not. Option : /All Process all files in the specified area's, even if they have already been processed. Example : PalmScan.Exe /L /FDBMAINT50-99 /ALL *.ARJ - This will process all *.ARJ files which are in the file-database in areas in the range 50 to 99 which have a destination archiver configured in the Ezycom/RemoteAccess file-area configuration. - 15 - PalmScan v1.13 User guide ----------------------------------------------------------------------- /Fix<+> Usage : Use the PalmScan FileInfo system. This system accomplishes an enhanced communication between PalmScan and programs using PalmScan. When using /FIX, PalmScan will use the FileInfo system in Read-Only mode, the FileInfo file (FILEINFO.FIX) will be deleted when all files have been processed. When using /FIX+, PalmScan will use the FileInfo system in Read/Write mode. PalmScan will update the FileInfo file with some information that can be used by the program which is calling PalmScan. Technical information about the FileInfo system can be found in FILEINFO.INC, which is included in the PalmScan package. <options> : /L Usage : Local operation. When this switch is NOT used, PalmScan will search for DOOR.SYS and/or DORINFO?.DEF to get the user information from. /C[configuration-filename] Usage : By default, PalmScan will search for it's configuration file in the same directory where PALMSCAN.EXE is placed, with the filename PALMSCAN.CFG. With this commandline option, you can tell PalmScan to use an alternate configuration file. Example : /Cc:\palmscan\afixpalm.cfg /D[dorinfo-filename] Usage : When your BBS-package creates a DORINFO file with a filename that can't be found by searching for DORINFO?.DEF (ie. Ezycom can create DORINF85.DEF for line 85), you can specify this filename here. Example : /Ddorinf85.def /N[node] Usage : When the node number is specified with this commandline option, PalmScan's multi-line support is enabled. This makes sure that PalmScan will run without problems when running on more nodes at the same time on multi-node systems. This commandline option is required when using the EzyFileID configuration keyword. - 16 - PalmScan v1.13 User guide ----------------------------------------------------------------------- /NoConversion Usage : When this option is used, no archiving will be done at all. This means that no archive will be converted, there won't be any file removal or file adding, no music modules will be described, and the archive header will not be updated. This can be especially useful for running PalmScan as online virus scanner (when the archive conversion is done in an event), or for just updating file descriptions in FILES.BBS with the 'FileID' keyword used. /T[archiver] Usage : Override the configured destination archiver. When no archiver is configured in the PalmScan configuration, PalmScan will only convert the main archives, no embedded archives. When there is an archiver configured in the PalmScan configuration, those settings will be used for SFX/Secure/Embedded archives. When used when running the file-database maintenance, PalmScan will still only process those areas which have a destination archiver configured (in the Ezycom/RemoteAccess file-area configuration). This commandline option does override that configured archiver, though. Example : /TARJ Note : This option is available in the registered version only. /NoFDB Usage : Temporary disable the file-database support. Note : This option is available in the registered version only. /NoFilesbbs Usage : Temporary disable the files.bbs support. Note : This option is available in the registered version only. /S Usage : When this option is used, PalmScan will search all sub- directory's of the given file-specifications for files to be processed. Together with the ProcessListedOnly configuration keyword, this option can very well be used to process all files on a bulletin board. - 17 - PalmScan v1.13 User guide ----------------------------------------------------------------------- /Unlisted Usage : When this option is used, PalmScan will only process files which are not listed in FILES.BBS and/or the RemoteAccess / Ezycom file-database. This commandline option overrides the ProcessListedOnly configuration keyword. /Move[Path] Usage : When a file has been processed and is ok, it can be moved to another directory. [Path] The directory where good files will be moved to. /NoMove Usage : Temporary disable the moving of files to the BadPath, InfectedPath, HackPath, OldPath and BadGifPath. When needed, PalmScan will exit with an errorlevel instead of moving any files. /Mono Usage : Forces monochrome mode. /NoCls Usage : Do not clear the screen at startup. /NoReg Usage : Do not display 'Registered to ...' at startup. Note : This option is available in the registered version only. /Debug Usage : This will log some more information on the execution of external programs (such as virus scanners, archivers, etc.) and virtually anything which is displayed on the screen. - 18 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 2.10 Watchdog, CTTY, ANSI.SYS CTTY and WATCHDOG, or similar utilities, are not required and should not be used with this program. PalmScan has its own communication routines which monitor the COM port. ANSI.SYS is not required for this program. When running under DESQview, DVANSI is not required either. It won't do any harm if either one is loaded however. 2.11 Errorlevels PalmScan returns the following errorlevels: 1 - Error 203 - Bad archive found 204 - Old file found 205 - Bad GIF file found 212 - Hacked archive found 213 - Infected file found The errorlevels 203, 212 and 213 will only be returned when no directory is configured to move those files to. - 19 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3 The configuration 3.1 PALMSCAN.CFG The PALMSCAN.CFG file is a normal (ASCII) text-file. You can create this file with any ASCII-editor. PalmScan will search for its configuration file in the directory containing PALMSCAN.EXE, or the configuration file specified on the commandline (see chapter 2.7). If no configuration file is found, PalmScan will terminate abnormally. PALMSCAN.CFG contains many options. Some of them are optional, others are not. The general format for the PALMSCAN.CFG file is: {statement} [mandatory parameter] <optional parameter> There are no restrictions to the position you start the parameters, but the parameters have to be separated with one or more spaces. The {statement} must start on position 1 of each line. When there should be spaces in a parameter (like in the archiver commands), you can use underscores ('_') for that, PalmScan will translate those in spaces. You can insert comment-lines into PALMSCAN.CFG by putting a '%' or a ';' character on position 1 of the desired line(s). Also empty lines are considered as comment. - 20 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2 PSetup Besides editing the configuration file with an ASCII editor, you can also configure PalmScan with PSetup. PSetup uses the same ASCII text-file as PalmScan. 3.2.1 Commandline The PSetup commandline consists of: PSETUP [configuration-filename] </A|-A> [configuration-filename] Usage : By default, PSetup will search for it's configuration file in the same directory where PSETUP.EXE is placed, with the filename PALMSCAN.CFG. With this commandline option, you can tell PSetup to use an alternate configuration file. </A|-A> Usage : When PSetup is started with /A or -A on the commandline, it will use an alternate colorset. Example : PSETUP c:\palmscan\afixpalm.cfg /A 3.2.2 Starting PSetup When you run PSetup, it will look for the configuration file as stated in paragraph 3.2.1. When no configuration file is found, it will inform you of this. The configuration file will then be created when you exit PSetup. 3.2.3 Keys PSetup uses pop-up menus. You can use the cursor up and down keys to move through the menus, and select an option by pressing Enter. The Escape key will take you back to a previous level. In all edit fields, Escape aborts and F10 keeps changes immediately (if you didn't select the 'Cancel' button). Cursor-Down and Tab moves the cursor to the next field, Cursor-Up and Shift-Tab moves the cursor to the previous field. Enter will move the cursor to the next field when on an edit field, and press a button when that button is currently selected. The space bar toggles on/off settings, Cursor-Left/Right will move through selection fields. F1 will display the relevant part of the PalmScan documentation when the cursor is located on a data entry. PalmScan.Doc must be located in the same directory where PSetup.Exe is located for this function to work. - 21 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.4 System data Here you can enter some information about your system. BBS name Keyword : BBSname [BBS_name] Usage : This option informs PalmScan of your BBS name. This option is only of use when you registered PalmScan and also use the RegKey statement. [BBS_name] This is your BBS name. Example : BBSname Oasis_BBS Key number Keyword : RegKey [nnnnn] Usage : When you registered PalmScan, you received a key for use with PalmScan. Enter this key with this keyword in the configuration so that PalmScan will display 'Registered to ...' instead of 'Unregistered evaluation copy', and all bonus features will be enabled. If you have not already registered PalmScan, please see the registration form for details on how to register. [nnnnn] This is your key number as you receive it after registering PalmScan. Example : RegKey 123456 SysOp name Keyword : SysopName [Sysop_Name] Usage : When writing messages in a Fido-style message board, PalmScan will write those messages to 'SysOp', unless your name is specified here, then it will write to your name. [Sysop_Name] Your name. Example : SysopName Steven_Hendriks - 22 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Net address Keyword : NetAddress [Zone:Net/Node<.Point>] Usage : Here you can specify you main network address, as installed in your mailer configuration. This is only used for messages created when bad or infected archives are found. If you don't have any network address, you don't have to enter anything here either. [Zone:Net/Node<.Point>] Your network address. <.Point> is optional. Example : NetAddress 2:2802/140 Uploader name Keyword : UploaderName [Name] Usage : By default, PalmScan uses 'PalmScan' and the version number as uploader name for files added to the RemoteAccess / Ezycom file-database. With this configuration keyword, you can specify an other name to use as uploader name. [Name] The name to be used as uploader name. Note : This option is available in the registered version only. - 23 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.5 Screen settings Redirect screen output of external programs Keyword : RedirectOutput Usage : PalmScan can redirect output of external programs (archivers and virus-scanners) to NUL. This means that those programs will display nothing to the local screen. Some programs, however, will still get output on the screen (like TBScan and F-Prot). When that happens, PalmScan will restore the screen to it's original looks after the external program has been executed. Enabling this option will cause the display on the local (SysOp) screen to be exactly the same as the display on the user screen. Example : RedirectOutput Normal color Keyword : ColorNormal [c] Usage : With this keyword, you can configure the color of normal text in PalmScan. [c] This is the color number. This can be any value from 0 to 15. Example : ColorNormal 3 Highlighted color Keyword : ColorHighlight [c] Usage : With this keyword, you can configure the color of highlighted text in PalmScan. [c] This is the color number. This can be any value from 0 to 15. Example : ColorHighlight 11 Background color Keyword : ColorBackground [c] Usage : With this keyword, you can configure the background color in PalmScan. [c] This is the color number. This can be any value from 0 to 7. Example : ColorBackground 0 - 24 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.6 General settings Running under FileDoor Keyword : FileDoor Usage : PalmScan has full FileDoor support. When this option is used, and archives are converted, PalmScan will inform FileDoor of the change in filesize and change of filenames. In cooperation with FileID, PalmScan will also give FileDoor the description of the file (when a FILE_ID.DIZ or DESC.SDI file was found inside the archive). When running in local-only mode (/L commandline option), PalmScan will not update any FileDoor files. Example : FileDoor Note : PalmScan assumes you are using FileDoor version 3.10ΓP or higher. If you are using an older version, you should not use the FileDoor parameter in cooperation with the FileID parameter, while the way FileDoor handles these descriptions has been changed in version 3.10ΓP. Update FILES.BBS / Extended descriptions character Keyword : FilesBBS [c] Usage : When this option is set, PalmScan will update the filename in the FILES.BBS file list when archive conversion is done, and, in cooperation with FileID, put the description of the file in this file list. [c] For using extended descriptions (descriptions consisting of multiple lines), PalmScan should know the character which is used by you BBS system for this option. SuperBBS uses '>', RemoteAccess uses '+'. By default, no extended descriptions character is used. Example : FilesBBS > Note : When no extended descriptions character is used, PalmScan cannot remove extended descriptions when adding a new description. Spaces to indent KeyWord : IndentSpaces [nn] Usage : With this option, you can set the number of spaces that should be indented in the FILES.BBS, before extended descriptions. Example : IndentSpaces 27 - 25 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Download counters Keyword : DownloadCounter [l] [r] [nnn] Usage : When a missing file has been added to the FILES.BBS files list, or when an extended description has been added, PalmScan will also update the download counter when you set this option. [l] This is the character that is being used as left bracket in the download counters. [r] This is the character that is being used as right bracket in the download counters. [nnn] This is the number of characters (numbers) that should be used in between the brackets. Example : DownloadCounter [ ] 3 - 26 - PalmScan v1.13 User guide ----------------------------------------------------------------------- File-DataBase Keyword : FDB [RA|Ezycom] Usage : PalmScan has full support for the RemoteAccess 2.0x and Ezycom 1.02 and 1.10 file-database. With this keyword, you can enable this. Filenames, sizes, dates, descriptions, etcetera are updated by PalmScan when needed. [RA] PalmScan will use the RemoteAccess 2.0x file-database. When an infected file is found, PalmScan will use the normal procedure to either move the file or exit with an errorlevel, and besides this it will also mark the file as deleted, unlisted and/or not available, according to the settings in the RemoteAccess configuration. When an archive can not be unpacked, PalmScan will also use the normal procedure, and it will mark the file as not available in the file-database. [Ezycom] PalmScan will use the Ezycom 1.02 or 1.10 file-database. PalmScan will detect the used version when reading the Ezycom configuration. When an infected file, an archive which can't be unpacked, or a file which exists in the HackList was found, PalmScan will use the normal procedure to either move the file or exit with an errorlevel, and it will mark the file as offline in the Ezycom file-database. When the FileID keyword is used with Ezycom 1.02, PalmScan will filter out all ascii control codes and all high ascii, and place the first non-empty line at the description in the Ezycom file-database. When using it with Ezycom 1.10, all description manipulation features are available. To prevent problems, here is some inside information: * When you are using on directory for different file areas in RemoteAccess/Ezycom, PalmScan will always use the FIRST area which uses the same directory as where the file which is being processed was found. * When PalmScan adds a description to the file- database, the old description will not be removed from the RemoteAccess database text. It will not be used for the file anymore, but will remain on your disk. To remove the old description, you should run RAFILE COMPRESS. * When PalmScan adds an unlisted file to the RemoteAccess file-database, it will add the default settings as configured in the RemoteAccess file- area configuration. Example : FDB RA - 27 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Import FILE_ID description Keyword : FileID <OneLine> <Filter> <FiltLow> <MaxWidth=value> <MaxLines=value> Usage : When this switch is set, PalmScan will import the description from the FILE_ID.DIZ or DESC.SDI file to FileDoor, FILES.BBS or the RemoteAccess file-database. <OneLine> Instead of placing descriptions from FILE_ID.DIZ or DESC.SDI on multiple lines (with the extended descriptions character), PalmScan can put those descriptions on one long line. To use this, OneLine must be specified at the FileID keyword. <Filter> PalmScan can filter out high ASCII (characters 128 to 255) from FILE_ID.DIZ or DESC.SDI descriptions. When this switch is used, all high ASCII characters will be removed from the description, and empty lines (which can be caused by removing high ASCII characters when a line consists of only those characters) will be removed. <FiltLow> PalmScan can filter out ASCII control-codes (characters 0 to 31) in FILE_ID.DIZ or DESC.SDI descriptions before importing them. <FiltDraw> PalmScan can filter out standard ASCII drawings (for which characters within the range 32 to 126 are used) in descriptions. This works a bit different than the control codes (FiltLow) and high ASCII (Filter) filter functions, while not everything should be filtered out. Just try it to see what it can do... <MaxWidth=value> The maximum width of imported descriptions can be configured with this option. <MaxLines=value> The maximum number of lines of imported descriptions can be configured with this option. Example : FileID OneLine Filter FiltLow FiltDraw MaxWidth=50 MaxLines=25 - 28 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Import FILE_ID description to Ezycom 1.10 Keyword : EzyFileID Usage : When running online under Ezycom 1.10, PalmScan can place the FILE_ID.<node> file in the temporary directory as configured in the Ezycom configuration. Ezycom will then import this description in the file-database. To use this feature, the node on which PalmScan is running must be specified on the commandline with the /N[node] commandline option. Also, the FileID keyword must be used in the PalmScan configuration. The OneLine, Filter, FiltLow and FiltDraw options also work with this function. The 'FDB Ezycom' keyword should not be used with this, or the /NOFDB commandline option should be used, the file-database support won't work when running in UPCONV.BAT anyway while Ezycom places uploaded files in a temporary upload directory. When running in local-only mode (/L commandline option) PalmScan will never create the FILE_ID.<node> file. Example : EzyFileID Describe MOD's Keyword : DescribeMod <OnlyMainArchive> Usage : PalmScan has the ability to describe MOD, NST, STM (ScreamTracker Modules), 669, JMusic and Organ music files. PalmScan will put the description of those files in a FILE_ID.DIZ descriptions file, which will be packed with the other files in the archive. This will only be done when no executables are found in the archive (ie. the archive only consists of music files), or when a FILE_ID.DIZ already exists in the archive (PalmScan will add the descriptions of the music files to this FILE_ID.DIZ in this case). With this keyword, you can enable this option. <OnlyMainArchive> When this switch is specified, only modules in the main archive will be described. When embedded archives are being processed, modules in those archives will be ignored. This is only valid when the ArchInArch keyword is used. When that keyword is not used, embedded archives would not be processed at all so modules in those archives would never be described either. Example : DescribeMod OnlyMainArchive - 29 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.7 Archive Conversion settings Only process new files Keyword : OnlyNewFiles <method> Usage : For running PalmScan in a daily event, it's possible to process only new files. When this option is used, PalmScan will only process files with the archive attribute set, and remove this attribute when a file has been processed, thus processing files only once. <method> By default, PalmScan will use the archive attribute on files to determine whether a file has been processed earlier or not. There are two other methods available: FileDate In this case, PalmScan will only process files which have a file date and time later than the last time a file has been processed in that directory. PalmScan will store the date in a file called LASTSCAN.PS, in the directory where the file was found. Because LASTSCAN.PS only contains the last date and time a file has been processed, it will affect the processing of ALL files in that directory. This method will use a directory entry (0-byte file) for each processed directory. DataFile In this case, PalmScan will only process files which are not found in the data file, and files with a changed size, date or time. The file which is used to store the data is called PALMSCAN.DAT. PalmScan uses separate datafiles for separate directory's, so when a file is being moved, it will also be processed. This method uses 12 bytes of disk space for each processed file (and a directory entry in each processed directory). The DataFile method is the most secure OnlyNewFiles method; The archive attribute method fails on systems where the archive attribute is being reset by another program (some backup programs do that), and the file date method affects complete directory's, where this method affects only the file which is processed. Example : OnlyNewFiles DataFile - 30 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Only process listed files Keyword : ProcessListedOnly Usage : By default, all files which comply with the given file specifications (and are not specified with the SkipFile keyword) will be processed. With this keyword, you can tell PalmScan to only process files which are listed in the FILES.BBS files list (when the FilesBBS keyword is used) and/or the RemoteAccess / Ezycom file-database (when the FDB keyword is used). Example : ProcessListedOnly Note : This feature is available in the registered version only. Put FILE_ID description in archive header Keyword : FileIDarchiveHdr Usage : When this switch is on, PalmScan will add the description from FILE_ID.DIZ or DESC.SDI to the archive header. When an archive header is already being added (ArchiveHeader keyword), the description will be appended to it. Example : FileIDarchiveHdr Archive conversion Keyword : ArchiveConversion [ttt] <OnlyMainArchive> <NoSFX> <NoSecure> <ToSFX> Usage : This option sets the target archive system. When no target archive system is set, no archive conversion will be done. [ttt] This sets the target. You can supply all values you configured with the Archiver statement. <OnlyMainArchive> When this switch is specified, only main archives will be converted to the target archive type. Embedded archives will still be processed for other options when ArchInArch is used, but those archives won't be converted. - 31 - PalmScan v1.13 User guide ----------------------------------------------------------------------- <NoSFX> When this switch is specified, self- extracting archives will not be converted to the target archive type, and no files will be removed from those archives. Also, the /NOCONVERSION commandline option will be used on archives embedded in self-extracting archives. <NoSecure> When this switch is used, secure archives (archives with a security envelope, authenticity verification or seal) will not be converted, no files will be removed or added, no music modules will be described, and an archive header will not be added to secured ARJ and UC2 archives. Also, the /NOCONVERSION commandline option will be used on archives embedded in secure archives. PalmScan can detect ARJ security envelopes, PkZIP (both 1.xx and 2.0x) and RAR authenticity verifications and UC2 seals. Note : This option is available in the registered version only. <ToSFX> When converting arcguces to self- extracting archives, this switch should be used. PalmScan will then use .EXE as the extension instead of the default extension which is configured for that archiver with the Archiver configuration keyword. Note : This option is available in the registered version only. Example : ArchiveConversion ZIP OnlyMainArchive NoSecure - 32 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Convert ALL archives Keyword : ConvertAll <OnlyMainArchive> Usage : Normally, PalmScan will only convert archives of other types than the target archive system. With this option you can tell PalmScan to convert all archives, even if it's already of the target archive type. <OnlyMainArchive> When this switch is specified, only main archives which are already in the target archive type will be converted, embedded archives which are already in the target archive type won't be converted. (This is only of use when the ArchInArch keyword is used). Example : ConvertAll OnlyMainArchive Process Self-Extracting archives Keyword : ProcessSFX <OnlyMainArchive> Usage : By default, Self-Extracting (SFX) archives, are not recognised as being archives. With this switch, you can tell PalmScan to process SFX archives, just like every other archive. PalmScan can detect ZIP, LHA, SQZ, ARJ and PAK SFX archives. <OnlyMainArchive> When this switch is specified, embedded SFX archives will not be processed. Example : ProcessSFX OnlyMainArchive Process embedded archives Keyword : ArchInArch Usage : PalmScan has the ability to process embedded archives. With this statement you can enable this feature. When ArchInArch is enabled, PalmScan will swap itself to XMS, EMS or disk, and startup another copy of itself. PalmScan leaves only 1k of memory used, so it should be able to handle well over 300 levels of embedded archives. PalmScan will do some things less with those embedded archives, than with main archives. It will not add archive headers, or move infected or bad archives (instead it will tell it's parent to do so). Example : ArchInArch Note : This is the main switch for embedded archive processing. When this is not used, all OnlyMainArchive switches will have no meaning. - 33 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Add CRC file list Keyword : AddCRCfile <OnlyMainArchive> Usage : PalmScan can create a list with all filenames, sizes, dates and CRC-32's of all files in the archive. This file will look like this: CRC-32 files list for : ARCHIVE.EXT Created by PalmScan 1.12 on BBS name File Size Date Time CRC-32 ----------------------------------------------- FILENAME.EXT XXXXXXXX XX-XX-XXXX XX:XX XXXXXXXX ----------------------------------------------- The filename of the list will be the same as the archive filename, with extension .CRC. <OnlyMainArchive> When this switch is specified, PalmScan will only create a CRC-32 list in the main archive. Embedded archives will not get a CRC-32 list. Example : AddCRCfile OnlyMainArchive Note : The BBS name will only be added for registered users. No title in headers Keyword : NoTitleInHdr Usage : By default, PalmScan will add it's title to archive headers, when an archive header is added (with the keywords ArchiveHeader and FileIDarchiveHdr). With this option, you can disable it. Example : NoTitleInHdr Note : This option is available in the registered version only. - 34 - PalmScan v1.13 User guide ----------------------------------------------------------------------- New archive date Keyword : Touch <Original|Today|Latest|Oldest|ResetFuture> Usage : When an archive has been processed, PalmScan can touch the file date and time on the archive. There are four possible ways: <Original> The processed archive will get the same date and time as the original archive. This is the default setting. <Today> The processed archive will get the current date and time. <Latest> The processed archive will get the date and time of the latest (newest) file in the archive. <Oldest> The processed archive will get the date and time of the oldest file in the archive. <ResetFuture> The processed archive will get today's date only when the original archive's date is a future date. When the original archive's date is a correct (older) date, the new archive will get the same date as the original archive. Note : This feature is available in the registered version only. - 35 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.8 Paths / filenames Temporary directory Keyword : TempPath [d:\path] Usage : TempPath should point to a directory where PalmScan will store temporary files. This directory is necessary for running PalmScan. [d:\path] This is the directory where the temporary files will be stored. When no temporary directory is configured, PalmScan will use the TEMP environment variable (when available). For more information about environment variables, consult your DOS documentation. Example : TempPath C:\TEMP Bad files directory Keyword : BadPath [d:\path] Usage : When a bad file has been encountered (ie. the file cannot be unpacked although it is an archive), PalmScan can move it to this directory. When this option is not used, PalmScan will exit with errorlevel 203 instead of moving the bad archive. [d:\path] This is the directory where PalmScan will move bad files to. Example : BadPath C:\FILES\BAD Infected files directory Keyword : InfectedPath [d:\path] Usage : When a virus has been found, PalmScan will move the file so you can investigate it further. When this keyword is not used, PalmScan will exit with errorlevel 213 instead of moving the infected file. [d:\path] This is the directory where PalmScan will move infected files to. Example : InfectedPath C:\FILES\INFECTED - 36 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Hacked files directory Keyword : HackPath [d:\path] Usage : When a file has been found in the hacklist, PalmScan will move this file so you can investigate it further. When this keyword is not used, PalmScan will exit with errorlevel 212 instead of moving the hacked file. Example : HackPath C:\FILES\HACKED Old files directory Keyword : OldPath [d:\path] Usage : PalmScan can check for files which are too old. When this check is configured (with the OldFiles configuration keyword), old files will be moved to the path configured with OldPath. When no OldPath is configured, PalmScan will exit with errorlevel 204 when encountering files which are too old. Example : OldPath C:\FILES\OLD Bad GIF files directory Keyword : BadGifPath [d:\path] Usage : When a bad GIF file (a GIF file with a resolution which is too low (MinimumResolution configuration keyword) or which failed the GIF test (GIFtest configuration keyword), the file will be moved to the path configured with BadGifPath. When no BadGifPath is configured, PalmScan will exit with errorlevel 205 on bad GIF files. Example : BadGifPath C:\FILES\BADGIF - 37 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Messagebase path Keyword : MessageArea [Type]<Number>[Path] Usage : When an infected file or a bad archive has been found, PalmScan can post a message to you, describing which archive contains infected file(s), which scanner(s) reported this, what action has been taken and which user was online at the time (when running in online mode). In addition to this, reports created by the virus scanner(s) which detected one or more virus(es) can be added to the message (for more information about this, read ******). By specifying a message area, this feature is enabled. PalmScan supports these messagebase types: Fido : F followed by the message path. Example : FC:\FD\NETMAIL Hudson : H followed by a 3 digit area number followed by the messagebase path. Example : H001C:\SBBS\MSGBASE Squish : S followed by the full path and filename of the message area. Example : SC:\MAX\MSG\PALMSCAN Ezycom 1.02 : E followed by the 4 digit area number followed by the messagebase path. Example : E0001C:\EZY\MSGBASE Ezycom 1.10 : Z followed by the 4 digit area number followed by the messagebase path. Example : Z0001C:\EZY\MSGBASE JAM : J followed by the full path and filename of the message area. Example : JC:\RA\MSG\PALMSCAN Because of the large code size consumption, the message system has been placed in an overlay file (PALMSCAN.OVR). If you do not use the message system, the overlay file can be removed. BBS system directory Keyword : BBSpath [d:\path] Usage : When using the RemoteAccess/Ezycom file-database ('FDB' keyword), PalmScan has to read some information from the RemoteAccess/Ezycom configuration. Either the RA/EZY environment variable or this keyword must be configured to be able to use the file-database. Example : BBSpath C:\RA - 38 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Files.bbs filename Keyword : FilesBBSname [filename] Usage : By default, PalmScan will use the file FILES.BBS in the same directory as the processed files, when the FilesBBS keyword is used. With this option, you can configure the filename for this files list. When it is configured to another name than FILES.BBS, PalmScan will first try this file, and if that fails it will still use the normal FILES.BBS. This option can be used for 4DOS DESCRIPT.ION files, or when you have your files list in a sub-directory of the directory where the files are located. When the latter is used, PalmScan will use this sub-directory for the files list, and when the sub-directory does not exist, the normal FILES.BBS will be used. Example : FilesBBSname LIST\FILES.BBS Log file / log style Keyword : LogFile [d:\path\filename.ext] <Compact|Expanded> Usage : PalmScan can keep track of its activity in a logfile. When this option is not used, no logging will be done. [d:\path\filename.ext] This is the full path and filename of the logfile PalmScan should maintain. When running on a multi-node system, PalmScan can use different log files for different nodes. %N in the log filename will be replaced by the node number on which PalmScan is running (this node number must be specified with the /N commandline option). When only a filename (no path) is configured, PalmScan will put the log file in the same directory as where PalmScan.Exe is located. <Compact> This is the default log style : ---------- Sat 01 Jan 94, PalmScan ... $ 12:34:56 Local operation <Expanded> This is an alternate log style : $ 01-Jan 12:34:56 PSCN PalmScan ... $ 01-Jan 12:34:56 PSCN Local operation Example : LogFile C:\LOG\PSCAN%N.LOG Expanded - 39 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Archive header file Keyword : ArchiveHeader [d:\path\filename.ext] Usage : PalmScan can add a header to your archives. When this parameter points to a valid ASCII textfile, this file will be used as header for the archive. [d:\path\filename.ext] This is the full path and filename to the header text file. When using UC2 as archiver, PalmScan can also add multimedia banners. The file configured with the ArchiveHeader keyword will be added as TXT banner, for multimedia banners, you should put the GIF/JPG/MOD/ASK files in the same directory and filename as the configured archive header, and with extension GIF/JPG/MOD/ASK. If you don't want to use the TXT banner, but do want to use other banners, you should put the filename of the other banners at the ArchiveHeader keyword without extension or with an extension of a non- existing file (never put GIF/JPG/MOD extensions there, PalmScan will then add these files as archive banner as if they were normal text files). Example : ArchiveHeader C:\PALMSCAN\HEADER.ASC Substitute drive Keyword : SubstDrive [Drive letter] Usage : When archiving files with sub-directory's, some archivers add complete path names instead of only the sub-directory's names to the archives. PalmScan can use a substituted drive for the archive conversion to make sure the correct directory names are in the archives. PalmScan will then call SUBST before every pack/unpack command. [Drive letter] The drive letter must be an unused drive and should be available when PalmScan is running (please test it with the SUBST command before using it in PalmScan). When an error occurs while SUBST is being called, PalmScan will use the normal pathname. Example : SubstDrive F - 40 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.9 Archivers Here you can define the name and commandline options for compression and decompression programs. Please make sure that the programs can be found in your path, or include a full path before the commands. Keyword : Archiver [ext] [compression] [decompression] <[addheader] <multi-volume switch>> Usage : This option can be used to tell PalmScan the archiver commands. [ext] This is the normal extension of archives created by this archiver. This will also be used as the name of the archiver within PalmScan. [compression] This is the full command for this archiver to compress files. [decompression] This is the full command for this archiver to extract archives. <addheader> This is the full command for this archiver to add a header to an archive (if available for this archiver). <multi-volume switch> The commandline option that should be added to the decompression command, to enable multi-volume support. (RAR doesn't need any switch, ARJ uses -v). Example : Archiver ARC pkarc_a pkxarc_-r_-e pkarc_x< Archiver PAK pak_a_/i pak_e_/wa pak_h< Archiver ZIP pkzip_-ex_-r_-p pkunzip_-o_-d pkzip_-z< Archiver LHA lha_a_/rxpatm lha_x_/c Archiver ZOO zoo_aPh zoo_eO// zoo_cA< Archiver ARJ arj_a_-r arj_x_-y arj_c_-z -v Archiver SQZ sqz_a_/p3_/s sqz_x_-o1 Archiver HAP hap_a pah_e Archiver UC2 uc_a_-s_-tt_-f_-b uc_e_-s_-f_!ban=off uc_a_-tt_-f_-b Archiver RAR rar_a_-r_-y_-o-_-std_-m5 rar_x_-r_-y_-o-_-std_-c- rar_c_-y_-std_-av Note : You can use up to 30 archivers in PalmScan. However, the first 11 are reserved for ARC, PAK ZIP, LHA, ZOO, SQZ, HYP, ARJ, HAP, UC2 and RAR (which PalmScan can automatically detect), so that leaves 19 others. PalmScan will look at the extensions of those 19 other archive types to determine what type it is. - 41 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.10 Archivers - Archive protection UC2 protection Keyword : UC2protection <BasicUpdates> <Delete> <Add> <Optimize> <Unprotect> <ReviseComment> Usage : When an archive has been converted to UC2, PalmScan can add all available UC2 protections to it. By default, no protection will be added. <BasicUpdates> Disable basic updates on processed archives. <Delete> Disable deleting files in processed archives. <Add> Disable adding files to processed archives. <Optimize> Disable optimize on processed archives. <Unprotect> Disable unprotect on processed archives. <ReviseComment> Disable comment revising on processed archives. Example : UC2protection Add Unprotect ReviseComment RAR lock Keyword : RARlock [command] Usage : When an archive has been converted to RAR, PalmScan can add a lock to it. By default, RAR archives will not be locked. [command] To enable RAR archive locking, the command to lock a RAR archive must be configured here. When you are a registered RAR user, an authenticity validation can also be added here. Example : RARlock RAR_k_-av - 42 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.11 Virus scan Files to scan Keyword : VirusScan <filespec> <filespecs> Usage : When this switched is used, PalmScan will scan for viruses inside all files with the scanners configured with the Scanner parameter. When this switch is not set, no virus scanning will be done. <filespec> This can be any valid DOS file specification. When you give any filespec (you may use up to 50 of them here), PalmScan will only execute the virus scanner(s) when one or more file(s) have been found that meet the requirements of these file specifications. When no file specifications are given, PalmScan will always execute the virus scanner(s). (In PSetup, there must always be at least one file specification, ie. *.*). Example : VirusScan *.EXE *.COM *.OVR *.OVL Virus scanners Keyword : Scanner [name] [command] [lll] <[hhh] <[nnn] <filespecs>>> Usage : This is one of the most important options in PalmScan. The files inside archives will be scanned with all configured virus scanners. [name] This is the name of the virus scanner. [command] This is the command for the virus scanner to be executed. The path/filename(s) of the file(s) to be scanned will NOT be automatically added to the commandline. There are some meta-commands which will be replaced with the correct string by PalmScan: @PATH The directory that should be scanned (without trailing backslash). @FILENAME The filename of the file(s) to be scanned. @FULL The path and filename of the file(s) to be scanned. (@FULL = @PATH\@FILENAME) - 43 - PalmScan v1.13 User guide ----------------------------------------------------------------------- @SPECIAL This meta-command is a special one; it will act like @FULL when a specific file should be scanned, and like @PATH when all files in a directory should be scanned. @REPORT When a virus has been found, PalmScan will include the report created by the virus scanner(s) which found one or more virus(es) in the message which is posted to the system operator. To use this feature, @REPORT must be included on the virus scanner commandline, along with the appropriate command for that program to create the report. PalmScan will replace @REPORT with a filename for the report. [lll] This is the lowest errorlevel the virus scanner will return when a virus has been found. <hhh> This is the highest errorlevel the virus scanner will return when a virus has been found. When it is not set, PalmScan assumes the virus scanner will only return errorlevel [lll] <nnn> This is the errorlevel that the virus scanner will return when nothing is wrong. Most virus scanners return errorlevel 0 when there are no problems, but there are some scanner which return another errorlevel just because there are no executables found. With this option you can make PalmScan simply ignore that errorlevel. <filespecs> Up to 5 file specifications can optionally be given. First, PalmScan will check the global file specifications (on the VirusScan keyword). When there are files which comply with those, the virus scanning will start. Before executing each virus scanner, PalmScan will check the file specifications for those virus scanners, and only execute them when there are no file specifications configured at that virus scanner or when there are files which comply with those specifications. - 44 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Examples : Scanner McAfee_Scan SCAN_/NOMEM_/A_/NOPAUSE_/SUB_/REPORT_@REPORT_@FULL 1 1 0 *.exe *.com *.ov? Scanner ThunderByte_Scan TBSCAN_AF_NB_NM_BA_IN_NA_OLD_LOG_LOGNAME=@REPORT_@SPECIAL 2 127 1 Scanner F-Prot F-PROT_/ALL_/COMMAND_/NOMEM_/OLD_/NOBOOT_/REPORT=@REPORT_ @FULL 3 3 0 Scanner AVScan AVSCAN_/NM_/NC_/Q_/R_/S_@FULL 100 255 0 *.exe *.com Scanner McAfee_Scan_2.0.x SCAN_/NOMEM_/SUB_@FULL 13 13 14 Note : You can use up to 20 virus scanners in PalmScan. They will be executed in the order they were found in the configuration. Complete scan Keyword : CompleteScan Usage : Normally, PalmScan will not process embedded archives when a virus has already been found. This feature enables the processing of those embedded archives, which is especially useful when using the message system. PalmScan will then create a complete overview of the infected files. Example : CompleteScan - 45 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.12 HackList Keyword : HackList [d:\path\filename.ext] <triggers> Usage : PalmScan can check a HackList (eg. 'The Hack Report' by Bill Lambdin) for dangerous files. [d:\path\filename.ext] This is the full path and filename of the .COL or .IDX file to use. If you want to use more than one of those (eg. reports of previous years and this year), you should copy those files to one file. Wildcards are not allowed for this option. <triggers> These are the sections (eg. HAK HOX TRO) which should trigger PalmScan to move the file to the hacked files directory or, when no hacked files directory is configured, exit with errorlevel 212. Up to 10 sections can be given. When no section is specified, or when you are using a .COL list (sections are not included in .COL lists), PalmScan will always be triggered. Example : HackList C:\PALMSCAN\HACK9401.IDX HAK HOX TRO PIR Note : The used format for the HackList is: FILENAME,year,section 3.2.13 Skip files Keyword : SkipFile [filespec] <filespecs> Usage : There are some files that should not be processed by PalmScan, for instance FILES.BBS or BIMODEM.LOG. With this parameter you can specify up to 50 valid DOS file specifications that should be skipped by PalmScan. Full path names can also be included in these file specifications. [filespec] This must be a valid DOS file specification. Example : SkipFile FILES.BBS BIMODEM.* SkipFile D:\FILES\SECURE\*.* - 46 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.14 Pack unpacked Keyword : PackUnpacked [filespec] <filespecs> Usage : With this option, you can tell PalmScan to archive un-archived files. All files which comply to one or more of the given file-specifications and are not archives, will be archived with the archiver configured with the ArchiveConversion keyword. [filespec] This must be a valid DOS file-specification. Example : PackUnpacked *.MOD *.STM *.ANS Note : Up to 50 file-specifications can be given. Minimum size Keyword : PackUnpackedSize [size] Usage : The minimum size for unpacked files which should be packed can be configured with this option. [size] This is the minimum size in bytes. Example : PackUnpackedSize 2048 3.2.15 Remove files Keyword : RemoveFile [filespec] <filespecs> Usage : Many archives contain some files which have no relation with the actual archive, like advertisements added by BBS SysOp's. This can eventually take up a great part of your available disk space. PalmScan can now remove these files from the archives. [filespec] This must be a valid DOS file-specification. Example : RemoveFile OASISBBS.ADV OASIS.BBS Note : Up to 50 file-specifications can be given. - 47 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.16 Add files Keyword : AddFile [filespec] Usage : Just like PalmScan can remove files from archives, it can also add files to them. You can use this to add an advertisement for your BBS, or whatever you want added to the archives. [filespec] This must be a valid DOS file-specification. Example : AddFile C:\TEXT\OASIS.BBS Note : Up to 10 AddFile keywords can be used. 3.2.17 GIF settings Add GIF specifications to descriptions Keyword : GIFspecs <[left bracket] ['by' character] [right bracket]> Usage : PalmScan will add GIF specifications (resolution and colors) to descriptions when this keyword is used. Optional are the characters that are used in the descriptions, but when specifying one of them, both others must be specified too. By default, these characters are used : ( x ) When used with FILES.BBS or the RemoteAccess file- database, PalmScan will first check if the specifications already exist in the description, and only add them when they do not already exist. Example : GIFspecs < * > - 48 - PalmScan v1.13 User guide ----------------------------------------------------------------------- GIF pack Keyword : GIFpack [title] [command] Usage : To convert GIF pictures to another format, this feature can be used. [title] This is only used to display to what format the file is being converted, but must be configured when using this feature. [command] This is the command that should be executed to convert the GIF picture. PalmScan will by default add the original filename and extension to the GIFpack commandline. This is configurable with these options: @FILENAME Will be replaced by the original filename. @EXT Will be replaced by the original extension. When the 'packed' file is larger than the original file, PalmScan will use the original file. Also, programs which replace the original file (eg. GIFlite) can be used with this feature. Example : GIFpack JFIF CJPEG.EXE @FILENAME.@EXT @FILENAME.JPG JFIF unpack Keyword : JFIFunpack [command] Usage : PalmScan will use this setting to convert JFIF files to GIF. JFIF files are standard JFIF/JPEG files, which can be created by CJPEG and some other graphics conversion utilities. [command] This is the command that should be executed to convert the JFIF file. Example : JFIFunpack DJPEG.EXE - 49 - PalmScan v1.13 User guide ----------------------------------------------------------------------- JPEG unpack Keyword : JPEGunpack [command] Usage : This is actually the same as JFIF unpack, with the difference that JPEG files are files which are incompatible with standard JFIF/JPEG files. Files created by (older versions of) GIF2JPG are such JPEG files. When this command is not configured, and JFIF unpack is configured, PalmScan will try to convert JPEG files to GIF using the command configured at JFIF unpack. [command] This is the command that should be executed to convert the JPEG file. Example : JPEGunpack JPG2GIF.EXE GIFblast unpack Keyword : GIFBLASTunpack [command] Usage : PalmScan will use this setting to convert GIFblast files to GIF. [command] This is the command that should be executed to convert the GIFblast file. Example : GIFBLASTunpack GFIBLAST.EXE_-D Repack JFIF files Keyword : JFIFrepack Usage : When this keyword is used, JFIF files will first be converted to GIF, and then converted using the command configured with the GIFpack keyword. Example : JFIFrepack Repack JPEG files Keyword : JPEGrepack Usage : When this keyword is used, JPEG files will first be converted to GIF, and then converted using the command configured with the GIFpack keyword. Example : JPEGrepack - 50 - PalmScan v1.13 User guide ----------------------------------------------------------------------- Repack GIFblast files Keyword : GIFBLASTrepack Usage : When this keyword is used, GIFblast files will first be converted to GIF, and then converted using the command configured with the GIFpack keyword. Minimum resolution Keyword : MinimumResolution [horizontal]x[vertical]x[colors] Usage : PalmScan can reject GIF, JFIF, JPEG and GIFblast files which have a resolution which is too low. When either one of the resolution values is lower than the configured value, PalmScan will move the file to the directory configured with the BadGifPath configuration keyword. When no BadGifPath is configured, PalmScan will exit with errorlevel 205. When a message area is configured, a message to the system operator will also be posted. [horizontal] The minimum horizontal resolution (width). [vertical] The minimum vertical resolution (height). [colors] The minumum number of colors. Example : MinimumResolution 320x200x256 GIF test command / failures Keyword : GIFtest [command] <errorlevels> Usage : PalmScan can use an external GIF testing program to test all GIF files. [command] The command to execute to test GIF files. <errorlevels> Up to 10 errorlevels can be configured. When the result from [command] is one of the configured errorlevels, PalmScan will move the file to the BadGifPath, or exit with errorlevel 205 when no BadGifPath is configured. When a message area is configured, a message to the system operator will also be posted. Example : GIFtest GIFTEST.EXE_/M:320x200x256 1 20 25 - 51 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 3.2.18 Old files Keyword : OldFiles [[-days]|[dd-mm-yyyy]] <Original|Latest|Oldest> Usage : PalmScan can check for files which are too old. Either the maximum age in days or a date can be used for this check. PalmScan will check for old files right after embedded archives have been processed. When an old file has been encountered, it will be moved to the directory configured with the OldPath configuration keyword. When no OldPath is configured, PalmScan will exit with errorlevel 204. When a message area is configured, a message to the system operator will also be posted. [-days] The maximum age of a file, in days. [dd-mm-yyy] The oldest allowed date of a file, in date-month-year format. <Original> PalmScan will use the original archive's date. <Latest> Use the latest date of the files inside the archive. <Oldest> Use the oldest date of the files inside the archive. Example : OldFiles -90 Latest 3.2.19 Information This is a small information window about PalmScan and PSetup. 3.2.20 Exit to dos This option will take you out of PSetup. If you have made any changes to the configuration, you will be asked if you want to save them before you exit. You also have the option to cancel and return back to PSetup. - 52 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 4 Registration After you have evaluated PalmScan for the period of one month, you must either register or discontinue using PalmScan. PalmScan is released as 'try before you buy', so please buy it if you like it. As long as you don't register, PalmScan will remind you that you have not registered when PalmScan is started up. To register, fill out the registration form and send it to the registration site. For information about prices and registration sites, see the registration forms included in this package. - 53 - PalmScan v1.13 User guide ----------------------------------------------------------------------- 5 Credits Thanks to all registered users and beta testers, for registering and testing this software, and for all suggestions I got from you. All brand and product names are copyrighted (C) by and/or trademarks (TM) or registered trademarks (R) of their respective holders: 4DOS JP Software Inc. Allfix Harald Harms ARJ Robert K. Jung AVScan H+BEDV Datentechnik GmbH CJPEG, DJPEG Thomas G. Lane Ezycom Peter Davies F-Prot Frisk Software International Fido Tom Jennings and Fido Software FileDoor Robert W. van Hoeven GIF CompuServe Incorporated GIF2JPG, JPG2GIF Handmade Software, Inc. GIFblast Isaac Dimitrovsky GIFtest Max Bernard and Dave Navarro, Jr. HAP, PAH Harald Feldmann Hudson messagebase Adam Hudson Hyper P. Sawatzki and K.P. Nischke IBM, PC-DOS International Business Machines Corp. LHA Haruyasu Yoskizaki Microsoft, MS-DOS Microsoft Corporation PAK NoGate Consulting PKARC, PKZIP PKWARE, Inc. QuickBBS Pegasus Software RAFT Chris Buijs RAR Eugene Roshal RemoteAccess, JAM Wantree Development and Andrew Milner SQZ J.I. Hammarsberg SuperBBS Aki Antman and Risto Virkkala TBScan Thunderbyte BV UltraCompressor II, UC2 Ad Infinitum Programs ViruScan McAfee Associates ZOO Rahul Dhesi - 54 - PalmScan v1.13 User guide ----------------------------------------------------------------------- I Index /All . . . . . . . . . . . . 15 JPEGunpack . . . . . . . . . 50 /C[configuration-filename] . 16 LogFile . . . . . . . . . . . 39 /Debug . . . . . . . . . . . 18 MessageArea . . . . . . . . . 38 /D[dorinfo-filename] . . . . 16 MinimumResolution . . . . . . 51 /FDBmaint<areanr<-areanr>> . 15 NetAddress . . . . . . . . . 23 /Fix<+> . . . . . . . . . . . 16 NoTitleInHdr . . . . . . . . 34 /L . . . . . . . . . . . . . 16 OldFiles . . . . . . . . . . 52 /Mono . . . . . . . . . . . . 18 OldPath . . . . . . . . . . . 37 /Move[Path] . . . . . . . . . 18 OnlyNewFiles . . . . . . . . 30 /NoCls . . . . . . . . . . . 18 PackUnpacked . . . . . . . . 47 /NoConversion . . . . . . . . 17 PackUnpackedSize . . . . . . 47 /NoFDB . . . . . . . . . . . 17 ProcessListedOnly . . . . . . 31 /NoFilesbbs . . . . . . . . . 17 ProcessSFX . . . . . . . . . 33 /NoMove . . . . . . . . . . . 18 RARlock . . . . . . . . . . . 42 /NoReg . . . . . . . . . . . 18 RedirectOutput . . . . . . . 24 /N[node] . . . . . . . . . . 16 RegKey . . . . . . . . . . . 22 /S . . . . . . . . . . . . . 17 RemoveFile . . . . . . . . . 47 /T[archiver] . . . . . . . . 17 Scanner . . . . . . . . . . . 43 /Unlisted . . . . . . . . . . 18 SkipFile . . . . . . . . . . 46 AddCRCfile . . . . . . . . . 34 SubstDrive . . . . . . . . . 40 AddFile . . . . . . . . . . . 48 SysopName . . . . . . . . . . 22 ArchInArch . . . . . . . . . 33 TempPath . . . . . . . . . . 36 ArchiveConversion . . . . . . 31 Touch . . . . . . . . . . . . 35 ArchiveHeader . . . . . . . . 40 UC2protection . . . . . . . . 42 Archiver . . . . . . . . . . 41 UploaderName . . . . . . . . 23 BadGifPath . . . . . . . . . 37 VirusScan . . . . . . . . . . 43 BadPath . . . . . . . . . . . 36 BBSname . . . . . . . . . . . 22 BBSpath . . . . . . . . . . . 38 ColorBackground . . . . . . . 24 ColorHighlight . . . . . . . 24 ColorNormal . . . . . . . . . 24 CompleteScan . . . . . . . . 45 ConvertAll . . . . . . . . . 33 DescribeMod . . . . . . . . . 29 DownloadCounter . . . . . . . 26 EzyFileID . . . . . . . . . . 29 FDB . . . . . . . . . . . . . 27 FileDoor . . . . . . . . . . 25 FileID . . . . . . . . . . . 28 FileIDarchiveHdr . . . . . . 31 FilesBBS . . . . . . . . . . 25 FilesBBSname . . . . . . . . 39 GIFBLASTrepack . . . . . . . 51 GIFBLASTunpack . . . . . . . 50 GIFpack . . . . . . . . . . . 49 GIFspecs . . . . . . . . . . 48 GIFtest . . . . . . . . . . . 51 HackList . . . . . . . . . . 46 HackPath . . . . . . . . . . 37 IndentSpaces . . . . . . . . 25 InfectedPath . . . . . . . . 36 JFIFrepack . . . . . . . . . 50 JFIFunpack . . . . . . . . . 49 JPEGrepack . . . . . . . . . 50 - 55 -